home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / shu194st.zoo / shellutils-1.9.4 / man / su.man < prev    next >
Encoding:
Text File  |  1994-03-16  |  4.2 KB  |  129 lines
  1.  
  2.  
  3.  
  4. SU(1L)                               SU(1L)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        su - run    a shell    with substitute    user and group IDs
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        s✓su✓u  [-flmp]  [-c     command]  [-s    shell] [--login] [--fast]
  12.        [--preserve-environment]              [--command=command]
  13.        [--shell=shell] [-] [--help] [--version]    [user [arg...]]
  14.  
  15. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  16.        This  manual  page  documents  the  GNU version of s✓su✓u.  s✓su✓u
  17.        allows one user to temporarily become  another  user.   It
  18.        runs  a    shell  with the    real and effective user    ID, group
  19.        ID, and supplemental groups of USER.  If    no USER    is given,
  20.        the  default  is     root,    the super-user.     The shell run is
  21.        taken from USER's password entry, or /bin/sh  if     none  is
  22.        specified  there.   If USER has a password, s✓su✓u prompts for
  23.        the password unless run by a user with real user    ID 0 (the
  24.        super-user).
  25.  
  26.        By  default, s✓su✓u does not    change the current directory.  It
  27.        sets the    environment variables `HOME' and `SHELL' from the
  28.        password     entry    for  USER,  and    if USER    is not the super-
  29.        user, sets `USER' and `LOGNAME' to USER.     By default,  the
  30.        shell is    not a login shell.
  31.  
  32.        If  one    or  more ARGs are given, they are passed as addi-
  33.        tional arguments    to the shell.
  34.  
  35.        s✓su✓u does not handle /bin/sh or other shells specially (set-
  36.        ting  argv[0] to    "-su", passing -c only to certain shells,
  37.        etc.).
  38.  
  39.        On systems that have syslog, s✓su✓u can be compiled to  report
  40.        failed,    and optionally successful, s✓su✓u attempts using sys-
  41.        log.
  42.  
  43.        This  program  does  not     support  a  "wheel  group"  that
  44.        restricts  who can s✓su✓u to    super-user accounts, because that
  45.        can help    fascist    system    administrators    hold  unwarranted
  46.        power over other    users.
  47.  
  48.    O✓OP✓PT✓TI✓IO✓ON✓NS✓S
  49.        _✓-_✓c _✓C_✓O_✓M_✓M_✓A_✓N_✓D_✓, _✓-_✓-_✓c_✓o_✓m_✓m_✓a_✓n_✓d_✓=_✓C_✓O_✓M_✓M_✓A_✓N_✓D
  50.           Pass  COMMAND, a single command line to run, to the
  51.           shell with a  _✓-_✓c    option    instead     of  starting  an
  52.           interactive shell.
  53.  
  54.        _✓-_✓f_✓, _✓-_✓-_✓f_✓a_✓s_✓t
  55.           Pass  the     _✓-_✓f  option  to    the shell.  This probably
  56.           only makes sense with c✓cs✓sh✓h    and t✓tc✓cs✓sh✓h, for  which  the
  57.           _✓-_✓f   option   prevents  reading  the  startup  file
  58.           (.cshrc).     With Bourne-like shells, the  _✓-_✓f  option
  59.           disables filename    pattern    expansion, which is not    a
  60.           generally    desirable thing    to do.
  61.  
  62.  
  63.  
  64. FSF               GNU Shell Utilities            1
  65.  
  66.  
  67.  
  68. SU(1L)                               SU(1L)
  69.  
  70.  
  71.        _✓-_✓-_✓h_✓e_✓l_✓p Print a usage message on standard    output    and  exit
  72.           successfully.
  73.  
  74.        _✓-_✓, _✓-_✓l_✓, _✓-_✓-_✓l_✓o_✓g_✓i_✓n
  75.           Make  the    shell a    login shell.  This means the fol-
  76.           lowing.  Unset  all  environment    variables  except
  77.           `TERM',  `HOME',    and  `SHELL'  (which  are  set as
  78.           described    above),    and `USER' and    `LOGNAME'  (which
  79.           are  set,     even  for  the     super-user, as    described
  80.           above), and set `PATH'  to  a  compiled-in  default
  81.           value.   Change  to USER's home directory.  Prepend
  82.           "-" to the shell's name, to make it read its  login
  83.           startup file(s).
  84.  
  85.        _✓-_✓m_✓, _✓-_✓p_✓, _✓-_✓-_✓p_✓r_✓e_✓s_✓e_✓r_✓v_✓e_✓-_✓e_✓n_✓v_✓i_✓r_✓o_✓n_✓m_✓e_✓n_✓t
  86.           Do  not  change  the  environment    variables `HOME',
  87.           `USER', `LOGNAME', or `SHELL'.  Run the shell given
  88.           in  the  environment  variable  `SHELL'  instead of
  89.           USER's shell from    /etc/passwd, unless the    user run-
  90.           ning  s✓su✓u    is  not    the superuser and USER's shell is
  91.           restricted.  A restricted    shell is one that is  not
  92.           listed in    the file /etc/shells, or in a compiled-in
  93.           list if that file    does not exist.      Parts     of  what
  94.           this  option  does can be    overridden by _✓-_✓-_✓l_✓o_✓g_✓i_✓n and
  95.           _✓-_✓-_✓s_✓h_✓e_✓l_✓l.
  96.  
  97.        _✓-_✓s_✓, _✓-_✓-_✓s_✓h_✓e_✓l_✓l _✓s_✓h_✓e_✓l_✓l
  98.           Run SHELL    instead    of USER's shell    from /etc/passwd,
  99.           unless the user running s✓su✓u is not    the superuser and
  100.           USER's shell is restricted.
  101.  
  102.        _✓-_✓-_✓v_✓e_✓r_✓s_✓i_✓o_✓n
  103.           Print version information    on standard  output  then
  104.           exit successfully.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128. FSF               GNU Shell Utilities            2
  129.